ETSITS131 130 V10.3.1 



(2012-05) 




Digital cellular telecommunications system (Phase 2+); 
Universal Mobile Telecommunications System (UMTS); 

LTE; 

(U)SIM Application Programming Interface (API); 

(U)SIM API for Java™ Card 

(3GPP TS 31.130 version 10.3.1 Release 10) 



£b 



36$ llfa 



A GLOBAL INITIATIVE 



U 



3GPP TS 31.130 version 10.3.1 Release 10 1 ETSI TS 131 130 V1 0.3.1 (2012-05) 



Reference 



RTS/TSGC-0631130va31 
Keywords 



GSM,LTE,UMTS 



ETSI 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel .: +33 4 92 94 42 00 Fax: +33 4 93 65 47 1 6 

Siret N°348 623 562 00017 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.org 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.org/tb/status/status.asp 

If you find errors in the present document, please send your comment to one of the following services: 

http://portal.etsi.org/chaircor/ETSI support.asp 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2012. 
All rights reserved. 

DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 
3GPP™and LTE™ are Trade Marks of ETSI registered for the benefit of its Members and 

of the 3GPP Organizational Partners. 
GSM® and the GSM logo are Trade Marks registered and owned by the GSM Association. 



ETSI 



3GPP TS 31.130 version 10.3.1 Release 10 2 ETSI TS 131 130 V1 0.3.1 (2012-05) 



Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
http://webapp.etsi.org/key/queryform. asp . 



ETSI 



3GPP TS 31.130 version 10.3.1 Release 10 3 ETSI TS 131 130 V1 0.3.1 (2012-05) 



Contents 



Intellectual Property Rights 2 

Foreword 2 

Foreword 4 

1 Scope 5 

2 References 5 

3 Definitions and abbreviations 6 

3.1 Definitions 6 

3.2 Abbreviations 6 

4 Description 6 

4.0 Overview 6 

4.1 (U)SIM Java Card™ Architecture 7 

5 File Access API 7 

6 (U)SAT Framework 7 

6.0 Overview 7 

6.1 Applet triggering 8 

6.1.1 Exception Handling 8 

6.2 Definition of Events 8 

6.3 Registration 12 

6.4 Proactive command handling 12 

6.5 Envelope response handling 13 

6.6 System Handler management 13 

6.7 (U)SAT Framework behaviour 14 

7 UICC toolkit applet 14 

8 Geo Location API 14 

Annex A (normative): Java Card™ (U)SIM API 15 

Annex B (normative): Java Card™ (U)SIM API identifiers 16 

Annex C (normative): (U)SIM API package version management 17 

Annex D (normative): USIM API jar files 18 

Annex E (informative): Change History 19 

History 20 



ETSI 



3GPP TS 31.130 version 10.3.1 Release 10 4 ETSI TS 131 130 V1 0.3.1 (2012-05) 



Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

Y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

Z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document defines the (U)SIM Application Programming Interface extending the "UICC API for Java 
Card™" [2]. 

This API allows to develop a (U)SAT application running together with a (U)SIM application and using GSM/3G 
network features. 

The present document includes information applicable to network operators, service providers, server - (U)SIM - and 
database manufacturers. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ETSI TS 101 220: "Integrated Circuit Cards (ICC); ETSI numbering system for 
telecommunication; Application providers (AID)". 

[2] ETSI TS 102 241 V9.2.0: "UICC API for Java Card™" 

[3] 3GPP TS 3 1 . 102: "Characteristics of the USIM Application" . 

[4] 3GPP TS 5 1 .01 1 Release 4: "Specification of the Subscriber Identity Module- Mobile Equipment 

(SIM -ME) interface". 

[5] 3GPP TS 23.041: "Technical realization of Cell Broadcast Service (CBS)". 

[6] 3GPP TS 31.101: "UlCC-terminal interface; Physical and logical characteristics". 

[7] 3GPP TS 31.1 1 1: "USIM Application Toolkit (US AT)". 

[8] 3GPP TS 5 1 .014 Release 4: "Specification of the SIM Application Toolkit for the Subscriber 

Identity Module - Mobile Equipment (SIM - ME) interface". 

[9] 3GPP TS 31.1 15: "Secured packet structure for the (U)SIM Toolkit applications". 

[10] 3GPP TS 23.040: "Technical realization of the Short Message Service (SMS)". 

[II] Sun Microsystems "Application Programming Interface, Java Card™ Platform, 3.0.1 Classic 
Edition" . 

[12] Sun Microsystems "Runtime Environment Specification, Java Card™ Platform, 3.0.1 Classic 

Edition". 

[13] Sun Microsystems "Virtual Machine Specification Java Card™ Platform, 3.0.1 Classic Edition". 

Note: SUN Java Card™ Specifications can be downloaded at http : II) ava. sun. com/products/j avacard 

[14] 3GPP TS 23.032: "Universal Geographical Area Description (GAD)". 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions defined in ETSI TS 102 241 [2] apply. 
(U)SAT Framework : (U)SAT extension of the CAT Runtime Environment. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations defined in ETSI TS 102 241 [2] apply. 



4 Description 

4.0 Overview 

This API is an extension to the ETSI TS 102 241 [2] "UICC API for Java Card™" and requires the implementation of 
this specification. 

The classes and interfaces described in this specification inherit functionality from the classes and interfaces specified 
in the "UICC API for Java Card™". 

The (U)SAT Framework described in this specification is an extension of the CAT Runtime Environment defined in 
ETSITS 102 241 [2]. 
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4.1 (U)SIM Java Card™ Architecture 

The overall architecture of the (U)SIM API is based on the "UICC API for Java Card™" defined in 
ETSITS 102 241 [2]. 
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Figure 1 : (U)SIM Java Card™ Architecture 



5 File Access API 

The (U)SIM file access API consists of the package uicc.usim.access. This package defines additional constants to those 
defined in the uicc. access package from ETSI TS 102 241 [2]. The access to the file system, defined in TS 51.011 [4] 
and TS 31.102 [3], is the one specified in ETSI TS 102 241 [2] via the UICC FileView Interface. When selecting a 
cyclic file the current record number is defined, this applies also to files located under DF GSM . 



(U)SAT Framework 



6.0 Overview 

The (U)SIM toolkit API consists of the uicc.usim.toolkit package for toolkit features defined in TS 31.111 [7] and 
TS 51.014 [8], and is based on the uicc.toolkit package defined in ETSI TS 102 241 [2]. 
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6.1 Applet triggering 

See ETSI TS 102 241 [2]. 

6-1-1 Exception Handling 

The following clause describes the handling of exceptions by the (U)S AT Framework in addition to the behaviour 
defined in ETSI TS 102 241 [2] for the CAT Runtime Environment. 

If an Applet triggered by EVENT_FORMATTED_SMS_PP_ENV event throws an ISOException with the reason code 
(0x6FXX), it shall be sent to the terminal. 

Other Exceptions shall not be propagated to the terminal. 



6.2 



Definition of Events 



The following events can trigger a Toolkit Applet in addition to the events defined in ETSI TS 102 241 [2], all short 
values are reserved in ETSI TS 102 241 [2]: 

Table 1:(U)SAT event list 



Event Name 


Reserved short 
value 


EVENT FORMATTED SMS PP ENV 


2 


EVENT FORMATTED SMS PP UPD 


3 


EVENT UNFORMATTED SMS PP ENV 


4 


EVENT UNFORMATTED SMS PP UPD 


5 


EVENT UNFORMATTED SMS CB 


6 


EVENT MO SHORT MESSAGE CONTROL BY NAA 


10 


EVENT FORMATTED SMS CB 


24 


EVENT EVENT DOWNLOAD IWLAN ACCESS STATUS 


30 


EVENT EVENT DOWNLOAD NETWORK REJECTION 


31 


EVENT EVENT DOWNLOAD CSG CELL SELECTION 


33 


EVENT FORMATTED USSD 


121 


EVENT UNFORMATTED USSD 


122 


EVENT EVENT DOWNLOAD IMS REGISTRATION 


119 


EVENT EVENT DOWNLOAD INCOMING IMS DATA 


120 



EVENT_FORMATTED_SMS_PP_ENV,EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD,EVENT_UNFORMATTED_SMS_PP_UPD 

There are two ways for a card to receive a Short Message Point to Point: via an ENVELOPE(SMS-PP 
DOWNLOAD) APDU as defined in TS 31.111 [7] and TS 51.014 [8] or an UPDATE RECORD EF SM s APDU 
as defined in TS 31.102 [3] and TS 51.01 1 [4]. The EF SMS can be either located under the DF Telecom or under 
any ADF as defined in TS 31.102 [3] and TS 51.011 [4]. 

The received Short Message may be: 

- formatted according to TS 31.1 15 [9] or an other protocol to identify explicitly the toolkit applet for 
which the message is sent; 

- unformatted (e.g. a toolkit applet specific protocol ) then the (U)SAT Framework will pass this data to all 
registered toolkit applets. 

When the Short Message is received as Concatenated Short Messages as defined in TS 23.040 [10], it is the 
responsibility of the (U)S AT Framework to link single Short Messages together to re - assemble the original 
message before any further processing. The original Short Message shall be placed in one SMS TPDU TLV 
(with TP-UDL field coded on one octet) included in the USATEnvelopeHandler. The concatenation control 
headers used to re-assemble the short messages in the correct order shall not be present in the SMS TPDU. The 
TP-elements of the SMS TPDU and the Address (TS - Service-Centre-Address) shall correspond to the ones in 
the last received Short Message (independently of the Sequence number of Information-Element-Data). 
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The minimum requirement for the (U)SAT Framework is to process a concatenated short message with the 
following properties: 

- the Information Element Identifier is equal to the 8 -bit reference number. 

- it contains uncompressed 8 bit data or uncompressed UCS2 data. 

EVENT_FORMATTED_SMS_PP_ENV 

Upon reception of a TS 31.115 [9] formatted Short Message Point to Point (Single or Concatenated) via 
an ENVELOPE, the (U)SAT Framework shall: 

- verify the security of the Short Message as per TS 3 1 . 1 15 [9] ; 

- trigger the toolkit applet registered with the corresponding TAR; 

- take the optional Application Data posted by the triggered toolkit applet if present; 

- secure and send the response packet using SMS-DELIVER-REPORT or SMS-SUBMIT. 
When the toolkit applet is triggered, data shall be provided deciphered. 

EVENT_UNFORMATTED_SMS_PP_ENV 

Upon reception of an unformatted Short Message Point to Point (Single or Concatenated) via an 
ENVELOPE, the (U)SAT Framework shall trigger all the Toolkit Applets registered to this event. 

NOTE: As a consequence of the Envelop eResponseHandler availability rules specified in clause 6.6, 
only the first triggered toolkit applet is guaranteed to be able to send back a response. 

EVENT_FORMATTED_SMS_PP_UPD 

Upon reception of a TS 31.115 [9] formatted Short Message Point to Point (Single or Concatenated) via 
an UPDATE RECORD EF SM s, the (U)SAT Framework shall: 

- update the EF SMS file with the data received, it is then up to the receiving toolkit applet to change 
the SMS stored in the file (i.e. the toolkit applet need to have access to the EF SMS file) 

- verify the security of the Short Message as per TS 3 1 . 1 1 5 [9] ; 

- convert the UPDATE RECORD EF SM s APDU into a COMPREHENSION TLV List; 

- trigger the toolkit applet registered with the corresponding TAR; 
When the toolkit applet is triggered, data shall be provided deciphered. 
The USATEnv elope Handler provided to the applet shall: 

- return BTAG_SMS_PP_DOWNLOAD to the getTagQ method call; 

- return the Comprehension TLV list length to the getLength() method call; 

The USATEnvelopeHandler provided to the applet shall contain the following COMPREHENSION 
TLVs: 

- Device Identities TLV 

The Device Identities Comprehension TLV is used to store the information about the absolute record 
number in the EF SMS file and the value of the EF SMS record status byte, and is formatted as defined 
below: 



Device identities Comprehension TLV 



Device Identities tag 



length = 02 



Absolute Record Number 



Record Status 
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With the absolute record number the toolkit applet can update EF SMS in absolute mode to change the 
received SMS (e.g. in a readable text). 

For Concatenated Short Message the Absolute Record Number and the Record Status will correspond 
to the last UPDATE RECORD EF SM s APDU received. 

- Address TLY 

The value is the TS-Service-Centre- Address (RP-OA) of the last UPDATE RECORD EF SM s APDU. 

- SMS TPDU TLV 

The value is the SMS TPDU provided deciphered and reassembled, if needed 

- AID TLV 

The AID comprehension TLV is present only if the EF SMS file updated is under an ADF. The value is 
the AID of the ADF as defined TS 3 1 . 1 1 1 [7] . 

The order of the TLVs given in the USATEnv elope Handler is not specified, 

NOTE: To get each COMPREHENSION TLV, it is recommended that the applet uses the 
ViewHandler.findTLV() methods 

EVENT_UNFORMATTED_SMS_PP_UPD 

Upon reception of an unformatted Short Message Point to Point (Single or Concatenated) via 
UPDATE RECORD EF SM s APDU, the (U)SAT Framework shall : 

- update the EF SMS file with the data received; 

- convert the UPDATE RECORD EF SM s APDU data into a COMPREHENSION TLV List (as 
described for EVENT _FORMATTED_SMS_PP_UPD)\ 

- trigger all the Toolkit Applets registered to this event. 

The content of EF SMS may have been modified by a previously triggered Toolkit Applet.. 

EVENT_FORMATTED_SMS_CB,EVENT_UNFORMATTED_SMS_CB 

The received Cell Broadcast Message, via an ENVELOPE (CELL BROADCAST DOWNLOAD) APDU as 
defined in TS 31.111 [7] and TS 51.014 [8] and, can be either: 

- formatted according to TS 31.1 15 [9] or an other protocol to identify explicitly the toolkit applet for 
which the message is sent; 

- unformatted ( e.g. using a toolkit applet specific protocol ), then the (U)SAT Framework will pass this 
data to all registered toolkit applets. 

When the Cell Broadcast Message is received as multiple pages as defined in TS 23.041 [5], it is the 
responsibility of the (U)S AT Framework to link single pages together to re-assemble the original message 
before any further processing. The original Cell Broadcast message shall be placed in one Cell Broadcast page 
TLV included in the USATEnv 'elope Handler. The message parameters shall correspond to the ones in the last 
received Cell Broadcast page (independently of the Page Parameter). 

EVENT_FORMATTED_SMS_CB 

Upon reception of a TS 31.1 15 [9] formatted Cell Broadcast message, the (U)SAT Framework shall: 

- verify the security of the Cell Broadcast message as per TS 3 1 . 1 15 [9] ; 

- trigger the toolkit applet registered with the corresponding TAR; 
When the toolkit applet is triggered, data shall be provided deciphered. 

EVENT_UNFORMATTED_SMS CB 



ETSI 



3GPP TS 31.130 version 10.3.1 Release 10 11 ETSI TS 131 130 V1 0.3.1 (2012-05) 

Upon reception of an unformatted Cell Broadcast message, the (U)S AT Framework shall trigger all the 
Toolkit Applets registered to this event. 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_NAA 

Upon reception of an ENVELOPE (MO SHORT MESSAGE CONTROL defined in TS 51.014 [8] and TS 31.1 1 1 [7]) 
APDU as defined in TS 31.101 [6] and TS 51.01 1 [4] the (U)SAT Framework shall trigger the Toolkit Applet registered 
to this event. The (U)SAT Framework shall not allow more than one Toolkit Applet to be registered to this event at a 
time(e.g. if a Toolkit Applet is registered to this event but not in selectable state the (U)SAT Framework shall not allow 
another Toolkit Applet to register to this event). 

EVENT_FORMATTED_USSD,EVENT_UNFORMATTED_USSD 

The received USSD String, via an ENVELOPE (USSD Data Download) APDU as defined in TS 31.111 [7], 
may be: 

• formatted according to TS 31.1 15 [9] or an other protocol to identify explicitly the toolkit applet for 
which the message is sent; 

• unformatted (e.g. a toolkit applet specific protocol) then the (U)SAT Framework will pass this data to 
all registered toolkit applets. 

When the USSD Message is received as concatenated as defined in TS 31.115 [9], it is the responsibility of the 
(U)SAT Framework to link single USSD Messages together to re-assemble the original message before any further 
processing. The original USSD message shall be placed in one USSD String TLV included in the 
USATEnv elope Handler. The USSD String parameters (DCS, PFI, CCF) shall correspond to the ones in the last 
received USSD String (independently of the CCF Sequence number). 

EVENT_FORMATTED_USSD 

Upon reception of a TS 31.1 15 [9] formatted USSD Message via an ENVELOPE, the (U)SAT Framework shall: 

• verify the security of the USSD Message as per TS 3 1 . 1 15 [9] ; 

• trigger the toolkit applet registered with the corresponding TAR; 

• take the optional Application Data posted by the triggered toolkit applet if present; 

• secure and send the response packet. 

When the toolkit applet is triggered, data shall be provided deciphered. 

EVENT_UNFORMATTED_USSD 

Upon reception of an unformatted USSD String via an ENVELOPE, the (U)SAT Framework shall trigger 
all the Toolkit Applets registered to this event. 

Note: As a consequence of the Envelop eResponseHandler availability rules specified in clause 6.6, 
only the first triggered toolkit applet is guaranteed to be able to send back a response. 

EVENT_EVENT_DOWNLOAD_IWLAN_ACCESS_STATUS 

EVENT _EVENT_DOWNLO AD _NETWORK_REJECTION 

EVENT_EVENT_DOWNLOAD_CSG_CELL_SELECTION 

EVENT _EVENT_DOWNLO AD _IMS_REGISTRATION 

EVENT_EVENT_DOWNLOAD_INCOMING_IMS_DATA 

Upon reception of an ENVELOPE (Event Download) APDU command as defined in TS 31.111 [7] the (U)SAT 
Framework shall trigger all the Toolkit applets registered to the corresponding event. 

The following events defined in TS 3 1 . 1 1 1 [7] shall be raised upon reception of the corresponding APDU defined in 
either TS 51.011 [4] orTS 31.101 [6]. 
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EVENT_PROFILE_DOWNLOAD 

EVENT_MENU_SELECTION,EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT _CALL_CONTROL_BY_NAA 

EVENT _TIMER_EXPIRATION 

EVENT _EVENT_DOWNLO AD _MT_C ALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVEN! "_EVENT_DOWNLO AD _CALL_DIS CONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT _EVENT_DOWNLO AD _USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_STATUS_COMMAND 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT _EVENT_DOWNLO AD _BROWSER_TERMINATION 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT _EVENT_DOWNLO AD _DISPLAY_PARAMETER_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 

EVENT_PROACTIVE_HANDLER_AVAILABLE 

EVENT_EXTERNAL_FILE_UPDATE 

EVENT _FIRST_COMM AND _AFTER_ATR 

EVENT _UNRECOGNIZED_ENVELOPE 

6.3 Registration 

A Toolkit Applet shall register to events described in 6.2 as defined in ETSI TS 102 241 [2]. 

Constants for these events are available in uicc.usim.toolkit.ToolkitConstants interface in Annex A. 

The uicc. toolkit. ToolkitException TAR_NOT_DEFINED shall be thrown if a Toolkit Applet has no TAR defined and 
registers to events: EVENT_FORMATTED_SMS_PP_ENV, EVENT_FORMATTED_SMS_PP_UPD, 
EVENT_FORMATTED_SMS_CB , EVENT_FORMATTED_USSD. 

The uicc.toolkit.ToolkitException.EVENT _ALREADY_REGISTERED shall be thrown if there is another Toolkit 
Applet already registered to EVENT _MO_SHORT_MESS AGE _CONTROL_BY_NAA. 

6.4 Proactive command handling 

There is no extension of the CAT Runtime Environment by the (U)S AT Framework for proactive command handling. 
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6.5 Envelope response handling 

For the events defined in the present document, the following rules apply: 

A Toolkit Applet can post a response by using the post() method or the postAsBERTLV() method defined in 
ETSI TS 102 241 [2]. The (U)SAT Framework shall return the Status Word as defined in TS 31.111 [7] and in 
TS 51.014 [8] depending on the current NAA. 

Case Of EVENT_MO_SHORT_MESSAGE_CONTROL_BY_NAA: 

- The rules defined for EVENT _CALL_CONTROL_BY_NAA in ETSI TS 102 241 [2] apply. 
Case Of EVENT_UNFORMATTED_SMS_PP_ENV: 

- See ETSI TS 102 241 [2]. 

Case Of EVENT_FORMATTED_SMS_PP_ENV: 

- When the post() or the postAsBERTLV( ) method is invoked, the (U)S AT Framework shall, according to bit 6 of 
the second octet of the SPI defined in TS 31.115 [9], build a SMS -DELI VER-REPORT or a SMS -SUB MIT. 

In case of a SMS -DELI VER-REPORT, the (U)SAT Framework shall return the Status Word for RP-ACK or RP- 
ERROR as defined in TS 31.111 [7] and in TS 51.014 [8] depending on the current NAA. 

In case of SMS-SUBMIT the boolean value method parameter shall be ignored by the (U)SAT Framework. If the SMS- 
SUBMIT is to be used, the (U)SAT Framework shall build and issue a Send Short Message proactive command as 
defined in TS 31.1 1 1 [7] and in TS 51.014 [8] depending on the current NAA . 

Case Of EVENT_FORMATTED_USSD: 

When the post() or the postAsBERTLV() method is invoked, the (U)S AT Framework shall build a USSD String 
to be sent back in the Return Result Component contained in the subsequent Facility message. In that case the 
(U)SAT Framework shall return the Status Word as defined in TS 31.111 [7]. 

Case Of EVENTJJNFORMATTEDJJSSD: 

- See ETSI TS 102 241 [2]. 



6.6 System Handler management 



For the handler management of the Proactiv eHandler, the ProactiveResponseHandler, the Envelop eHandler and the 
EnvelopeResponseHandler, the rules defined in ETSI TS 102 241 [2] apply. 

USA TEnvelop eHandler: 

The single system instance of the USATEnvelop eHandler and the single system instance of the Envelop eHandler are 
two distinct objects instances. 

When available the USATEnvelop eHandler shall remain available and its content shall remain unchanged from 
the invocation to the termination of the processToolkit() method. 

The TLV List provided in the USATEnvelop eHandler are the same as in the Envelop eHandler. 

The handler availability of the USATEnvelop eHandler is the same handler availability as the Envelop eHandler 
including all the events defined in ETSI TS 102 241 [2]. 

The following table describes the minimum availability of the handlers for all the events at the invocation of the 
processToolkit() method of the Toolkit Applet. The rules described in this table apply in addition to the rules described 
in "UICC API for Java Card™" 
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Table 2: Handler availability for each event 



EVENT_ 


Reply busy 
allowed 


EnvelopeHandler / 
USATEnvelopeHandler 


EnvelopeResponse 
Handler 


Nbof 

triggered / 

registrered 

Applet 


_FORMATTED_SMS_PP_ENV 


Y 
(see Note 1 ) 


Y 


Y 


1 / n (per TAR) 


FORMATTED SMS PP UPD 


N 


Y 


N 


1 / n (per TAR) 


UNFORMATTED SMS PP ENV 


Y 


Y 


Y 


n / n 


UNFORMATTED SMS PP UPD 


N 


Y 


N 


n / n 


_FORMATTED_SMS_CB 


Y 


Y 


N 


1/n(perTAR) 


UNFORMATTED SMS CB 


Y 


Y 


N 


n / n 


_MO_SHORT_MESSAGE_CONTROL_BY_NAA 


N 


Y 


Y 


1 /1 


FORMATTED USSD 


Y 


Y 


Y 


1 / n (per TAR) 


UNFORMATTED USSD 


Y 


Y 


Y 


n / n 


EVENT DOWNLOAD 










IWLAN ACCESS STATUS 


Y 


Y 


N 


n/n 


_NETWORK_REJECTION 


Y 


Y 


N 


n/n 


IMS REGISTRATION 


Y 


Y 


N 


n/n 


_INCOMING_IMS_DATA 


Y 


Y 


N 


n/n 


NOTE 1 : The framework may reply busy and not trigger the toolkit applet if e.g. a PoR using SMS SUBMIT is required in 
the incoming message and a proactive session is ongoing. 



6.7 (U)SAT Framework behaviour 



The (U)SAT Framework is a (U)SAT extension of the CAT Runtime Environment as defined in ETSI TS 102 241 [2]. 
In addition, the (U)SAT Framework shall consider the EVENT_EVENT_DOWNLOAD_* defined in this specification 
when issuing the SET UP EVENT LIST system proactive command. 



7 



UICC toolkit applet 



See ETSI TS 102 241 [2]. 



8 



Geo Location API 



The Geo Location API consists of the package uicc.usim.geolocation. This package defines services to allow an Applet 
to perform a geographical location operation, depending of the ME capabilities. When a geographical location operation 
is requested, the API will follow a defined way to choose either "Geographical Location Request" toolkit command or 
"Provide Local Information" toolkit command as defined in TS 31.111 [7] to determine the location information. The 
result is formatted using GAD shapes as defined in TS 23.032 [14]. 
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Annex A (normative): 
Java Card™ (U)SIM API 



The attached files "31130_Annex_A_Java.zip", and "31130_Annex_A_HTML.zip" contains source files and html 
documentation for the Java Card™ (U)SIM API. 
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Annex B (normative): 

Java Card™ (U)SIM API identifiers 

The attached file "31130_Annex_B_Export_files.zip" contains the export files for the uicc.usim.* package. 
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Annex C (normative): 

(U)SIM API package version management 

The following table describes the relationship between each TS 31.130 specification version and its packages AID and 
Major, Minor versions defined in the export files. 



TS 31.130 


uicc.usim.access package 


uicc.usim.toolkit package 


AID 


Major, 
Minor 


AID 


Major, 
Minor 




A0 00 00 00 87 10 05 FF FF FF FF 89 13 
10 00 00 


1.0 


A0 00 00 00 87 10 05 FF FF FF FF 89 13 
20 00 00 


1.0 


7.1.0 


A0 00 00 00 87 10 05 FF FF FF FF 89 13 
10 00 00 


1.0 


AO 00 00 00 87 10 05 FF FF FF FF 89 13 
20 00 00 


1.1 


7.2.1 


A0 00 00 00 87 10 05 FF FF FF FF 89 13 
10 00 00 


1.0 


AO 00 00 00 87 10 05 FF FF FF FF 89 13 
20 00 00 


1.2 


10.1.0 


A0 00 00 00 87 10 05 FF FF FF FF 89 13 
10 00 00 


1.0 


AO 00 00 00 87 10 05 FF FF FF FF 89 13 
20 00 00 


1.7 


10.2.0 


AO 00 00 00 87 10 05 FF FF FF FF 89 13 
10 00 00 


1.0 


AO 00 00 00 87 10 05 FF FF FF FF 89 13 
20 00 00 


1.8 



The package AID coding is defined in ETSI TS 101 220 [1]. The (U)SIM API packages' AID are not modified by 
changes to Major or Minor Version. 

The Major Version shall be incremented if a change to the specification introduces byte code incompatibility with the 
previous version. 

The Minor Version shall be incremented if a change to the specification does not introduce byte code incompatibility 
with the previous version. 

The package uicc.usim.access contains only constants, therefore it may not be loaded on the UICC. 
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Annex D (normative): 
USIM API jar files 

The attached files "31130_Annex_D.jar", contains class files for the Java Card™ (U)SIM API. 
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Annex E (informative): 
Change History 



TSG/ 
Date 


TSG doc 


WGdoc 


CR 


Rev 


Subject/Comment 


New 


TP-27 










Generation of Version 7.0.0 based on version 6.2.0 


7.0.0 


TP-27 


TP-050023 


T3-050187 


009 




Allow passing of specified status words through the (U)SAT 
Framework 


7.0.0 


CT-28 


CP-050139 


C6-050445 


011 




Allign paragraph numbering between TS 31.130 and 
ETSI TS 102 241 


7.1.0 


CT-28 


CP-050139 


C6-050446 


013 




Delete version and author info from the Java source code 


7.1.0 


CT-28 


CP-050141 


C6-050420 


014 




Addition of new events EVENT FORMATTED USSD and 
EVENT UNFORMATTED USSD 


7.1.0 


CT-29 


CP-050340 


C6-050691 


016 




Adding missing constant values 


7.2.0 












2005-1 1 : Adds missing attachment files and adds line to table in 
annex C. 


7.2.1 


CT-33 


CP-060391 


C6-060520 


019 


1 


Correction of misnamed constant 


7.3.0 


C6-060590 


020 


1 


Addition of missing event download l-WLAN access status 


CT-34 


CP-060546 


C6-060791 


0022 


2 


Clarification on getShortMessagel_ength() method when applied on 
a SMS Cell Broadcast. 


7.4.0 


CP-050548 


C6-060798 


0024 


1 


Correction of the USATEnvelopeHandlerSystem method prototype 


CT-35 


CP-070068 


C6-070093 


0027 


1 


Correction of Annex A JAVA.zip, package uicc.usim.toolkit 


7.5.0 


C6-070125 


0028 


2 


Update the reference to Java Card 2.2.2 


CT-36 


CP-070302 


C6-070257 


0029 


- 


Correction of the reference to ETSI TS 102 241 


7.6.0 


CP-070298 


C6-070323 


0029 


- 


Correction of references to ETSI TS 102 223 and ETSI TS 102 221 


CT-38 


CP-070844 


C6-070564 


0032 


1 


Introduction of new constant values for files in the USIM application 


7.7.0 












Annex A and B attachments provided (2008-08) 


7.7.1 


CT-42 


CP-080908 


C6-080455 


0034 


2 


Introduction of a geographical location discovery Java Card™ API 


8.0.0 


CT-43 


CP-090196 


C6-090065 


0035 


1 


Introduction of missing constant values for USIM files 


8.1.0 


CT-45 


CP-090719 


C6-090334 


0039 


2 


Alignment of constants with 31 .1 1 1 


8.2.0 


CT-46 


CP-090788 


C6-090493 


0040 


1 


References update 


8.3.0 


CT-46 


CP-091013 


C6-090469 


0042 


1 


Support of missing event 

EVENT EVENT DOWNLOAD NETWORK REJECTION 


8.3.0 


CT-46 


CP-091013 


C6-090470 


0045 


1 


Support of missing constants in USAT Terminal Profile 


8.3.0 


CT-46 


- 


- 


- 


- 


Upgrade of the specification to Rel-9 


9.0.0 


CT-47 


CP-100185 


C6-1 00091 


0047 


1 


Addition of missing constant values 


9.1.0 


CT-47 


CP-100198 


C6-1 00086 


0048 


2 


Supporting operator controlled CSG list for H(e)NB 


9.1.0 


CT-47 


CP-100198 


C6-100108 


0049 


2 


Support of CSG cell discovery and CSG selection event 


9.1.0 












Spec reissued as v9.1 .1 due to a bad version number on the cover 
sheet 


9.1.1 


CT-50 


CP-1 00836 


C6-1 00600 


0046 


1 


Update reference to "Java Card 3.0.1 Classic" reference 


9.2.0 


SP-51 


- 


- 


- 


- 


Upgrade of the specification to Rel-10 


10.0.0 


CT-52 


CP-1 10507 


- 


0050 


1 


Addition of events and reservation of constant values for Java API 


10.1.0 


CT-54 


CP-1 10905 


- 


0053 


- 


Correction to TAG CSG SELECTION STATUS 


10.2.0 


CT-54 


CP-1 10905 


- 


0054 


- 


Correction to constant value in TerminalProfile.java 


10.2.0 


CT-55 


CP-1 201 54 


C6-1 20070 


0059 




Correction to TAG CSG SELECTION STATUS 


10.3.0 


CT-55 


CP-1 201 54 


C6-1 20071 


0060 




Correction to constant value in TerminalProfile.java 


10.3.0 


CT-55 


CP-1 201 54 


C6-1 20093 


0058 


1 


Update the reference to ETSI TS 102 241 


10.3.0 












Editorial version correcting the three lines above 


10.3.1 
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